home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / programming / utilities / hunkx.lha / HunkX / HunkX.doc < prev    next >
Encoding:
Text File  |  1992-08-03  |  4.6 KB  |  194 lines
  1.  
  2.  
  3.                          HunkX v2.00 User's Manual                   1
  4.  
  5.  
  6.                                 HunkX v2.00
  7.  
  8.                      Copyright © 1991, 1992 Peter Stuer
  9.                             All rights reserved
  10.  
  11.                          Release date July 3, 1992
  12.  
  13.                                  FREEWARE
  14.  
  15.                                 User Manual
  16.  
  17.  
  18.      COPYRIGHT NOTICE 
  19.  
  20.        HunkX software and documentation are © 1991, 1992 by Peter
  21.      Stuer.  All rights reserved.  
  22.  
  23.  
  24.      DISCLAIMER 
  25.  
  26.        HunkX has been thoroughly tested and is the result of a
  27.      constant process of changes and updates that started in January
  28.      1991.  The program has proven to be stable in everyday use.  The
  29.      author is not responsible for any loss of data, damages to
  30.      software or hardware that may result directly or indirectly from
  31.      the use of this program.  The author reserves the right to make
  32.      changes to the software or documentation without notice.  
  33.  
  34.  
  35.      PREFACE 
  36.  
  37.        This program is freeware, this means that you can copy it
  38.      freely as long as you don't ask any more money for it than a
  39.      nominal fee for copying.  If you want to distribute this program
  40.      you should keep this document with it.  This program cannot be
  41.      used for commercial purposes without written permission from the
  42.      author.  
  43.  
  44.        Special permission is hereby granted to include HunkX in
  45.      Public-Domain collections such as Fred Fish's Amiga Library.  
  46.  
  47.  
  48.      Chapter 1 Introducing HunkX     
  49.  
  50.        HunkX is a small utility written completely in Assembler to
  51.      show the hunkx structure of any segment-loadable file.  It has
  52.      been tested with normal Amiga executables, object files,
  53.      libraries, Lattice C linker libraries, all with or without
  54.      debugging or symbol information.  Note that the Aztec C linker
  55.      libraries are not supported since they are not standard.  All
  56.      the new hunks in KickStart 2.0 are also supported.  
  57.  
  58.        Non-programmers won't have a lot of use for HunkX.  It display
  59.      technical information that can be useful for programmers only.  
  60.  
  61.  
  62.  
  63.  
  64.      
  65.  
  66.  
  67.                          HunkX v2.00 User's Manual                   2
  68.  
  69.  
  70.      1.1 System requirements      
  71.  
  72.        HunkX should run on any Amiga system with at least 512KB RAM
  73.      and one disk-drive.  HunkX requires KickStart v2.04 or higher to
  74.      run.  
  75.  
  76.        Should you have any trouble running HunkX on your machine,
  77.      please write to me with the full specifications of your machine,
  78.      that is KickStart version, model, expansion boards etc...  
  79.  
  80.  
  81.      1.2 About the program     
  82.  
  83.        If you have suggestions or remarks about this program, or if
  84.      you find any bugs, please let me know.  
  85.  
  86.        When sending in bug reports, please state exactly under what
  87.      circumstances the bug occurred, what equipment was used and what
  88.      happened.  If possible also try to give me enough information to
  89.      reproduce the bug.  It is very difficult to find bugs when you
  90.      don't know exactly what happened.  
  91.  
  92.      Write to the following address: 
  93.  
  94.              Peter Stuer
  95.              Kauwlei 21
  96.              B-2550 Kontich
  97.              Belgium - Europe
  98.  
  99.              Fido: 2:292/603.7
  100.  
  101.  
  102.      1.3 Usage       
  103.  
  104.        HunkX is for CLI usage only.  Trying to run HunkX from the
  105.      Workbench may result in a system crash.  
  106.  
  107.        If you run HunkX without any arguments get a message similar
  108.      to the following one: 
  109.  
  110.              HunkX v2.00 by Peter Stuer (2.7.92 18:56:08) FREEWARE 
  111.              Examines the hunk structure of an executable file.  
  112.  
  113.        If you run HunkX with an questionmark (?) as argument you'll
  114.      get the argument template: 
  115.  
  116.              FROM/A/M,V=VERBOSE/S: 
  117.  
  118.        You can supply as many arguments as you like. If the argument
  119.      is a directory or a device all the files in that directory or
  120.      device will be examined.  
  121.  
  122.        If you also supply the VERBOSE switch HunkX will show you a
  123.      lot more information f.e. all the debugging symbols (if any).  
  124.  
  125.        The output can be stopped at any time by pressing Control-C.  
  126.  
  127.  
  128.      
  129.  
  130.  
  131.      
  132.  
  133.  
  134.                              Table Of Contents
  135.  
  136.                                 HunkX v2.00
  137.  
  138.      Chapter 1 Introducing HunkX    ............................    1
  139.         1.1 System requirements     ............................    1
  140.         1.2 About the program    ...............................    2
  141.         1.3 Usage      .........................................    2
  142.  
  143.      © 1992 HunkX v2.00 written by Peter Stuer
  144.  
  145.                   _
  146.                _ //
  147.      Thanks to \X/ Amiga for being the best computer ever !
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.      
  193.  
  194.